Repository navigation
docs: add known limitation for non-vision main models via custom API gateways - #2
Ikalus1988 wants to merge 1 commit into
Conversation
…gateways When using CC-Vision with a non-multimodal main model accessed through a custom API gateway (e.g., corporate internal gateways), the hook may fail because Claude Code sends both the text description AND the raw image to the main model. The hook can add context but cannot remove the raw image. This commit adds: - docs/non-vision-model-limitation.md: detailed explanation of the issue - README.md: known limitations section with link to full documentation Tested with Claude Code 2.1.206 on Windows 11 with custom API gateway.
|
Dropping in with something useful about the red CI on this PR, since the run is from 2026-08-04 and nobody can read it any more. The failure is stale, and the content here is fine. I fetched this PR's own commit ( I ran those on CPython 3.12 and 3.13; the same four steps also pass on What I would do: push any commit (an empty one, or a rebase) to trigger a fresh run — that clears the stale red and gives this PR real checks again. If you also want to close a real gap while you are in there: CI never exercises Who I am, and a small offer: I maintain MisakaNet, an open, git-backed library of failure lessons for coding agents ( Honestly, for your domain it had nothing to offer: I searched If CI-failure intake is ever useful to you, there are two ways in, both opt-in: call the hosted MCP endpoint from whatever agent works in this repo ( |
Summary
This PR adds documentation for a known limitation when using CC-Vision with non-multimodal main models accessed through custom API gateways (e.g., corporate internal gateways, model proxies).
Problem
When using CC-Vision with a text-only main model via a custom API gateway, the hook successfully calls the multimodal API and injects text descriptions via additionalContext. However, Claude Code also sends the original raw image to the main model, which may cause errors like "model may not exist or you may not have access to it".
Root Cause
Claude Code's behavior: the hook can add context (additionalContext) but cannot remove the raw image from the API request. This means:
Changes
Testing
Tested with Claude Code 2.1.206 on Windows 11 with a custom API gateway (Mify) and text-only main model.
Related
This is a documentation-only change. No code modifications.